.. _secdoPutOne:

secdoPutOne
================
----------------

SYNOPSYS
`````````````
.. code-block:: none

  t_success secdoPutOne(
      [in] t_i32 NetID, 
      [in] t_ui32 DoChannel, 
      [in] t_bool OutState,
      [out] t_i32 *ErrCode
    )




DESCRIPTION
`````````````  

- 단일 디지털 출력 채널에 출력을 발생시킵니다.


PARAMETER
`````````````
- NetID  : 사용자가 사용 할 Network 번호

- DoChannel : 디지털 출력 **전역채널** 번호(0 base)

- OutState : 단일 채널에 대한 디지털 출력상태를 발생합니다.

+-------+---------+
| Value | Meaning |
+=======+=========+
| 0     | OFF     |
+-------+---------+
| 1     | ON      |
+-------+---------+

- ErrCode : 이 매개 변수를 통하여 현재의 에러 코드를 반환합니다. 단, 이 매개 변수에 NULL을 전달하면 에러 코드를 반환하지 않습니다.


RETURN VALUE
`````````````

-  함수 수행 성공 여부를 반환합니다.

+-------+---------+
| Value | Meaning |
+=======+=========+
| 0     | 실패    |
+-------+---------+
| 1     | 성공    |
+-------+---------+

Example
`````````````

.. code-block:: c++
 :linenos:

    #include "ComiSWECATSdk_Api.h"
    #define DO_CHNUMBER 0 //사용자가 출력을 원하는 DO 채널 번호

    void DO_PutOne(void)
    {
        t_i32 NetID = 0; // Network ID
        t_32 Error_Num = 0; // 에러 코드 저장 변수
        t_bool State = 1; // 출력 값

        if(!secdoPutOne (NetID, DO_CHNUMBER, State, &Error_Num))
        {
            //DO 실패 시 예외 처리
        }

    } // DO_PutOne 함수 종료


.. seealso:: :ref:`secdoGetOne`  , :ref:`secdoPutMulti`